home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / gw.zip / GW.DOC next >
Text File  |  1993-03-07  |  6KB  |  161 lines
  1. Support pc Ltd                                    Freeware
  2. Simon P. Lucy    
  3.     
  4.  
  5.  
  6.         A Gateway between Pegasus Mail and KA9Q
  7.     
  8.     Introduction
  9.  
  10.     This software, GWIN.EXE and GWOUT.EXE, is a gateway between
  11.     Pegasus mail and KA9QNOS.  This means that standalone users
  12.     can use the full features of Pegasus mail together with the
  13.     access to the Internet given by KA9Q.
  14.     
  15.     Whereas Pegasus users on a Novell network with a direct
  16.     connection to the Internet can use Charon to transport and
  17.     convert their email, standalone users have very little 
  18.     sophisticated email support.  The two GW programs are, if
  19.     you like, a standalone version of Charon when used in 
  20.     conjunction with KA9Q.
  21.     
  22.     License
  23.     
  24.     In the spirit of the distribution of Pegasus this gateway is
  25.     freeware, but copyright Support pc Ltd, and as such can be
  26.     used without restriction except that it cannot be supplied as
  27.     part of a commercial installation and no payment can or should
  28.     be charged for its distribution.
  29.     
  30.     Installation
  31.     
  32.     The Gateway depends upon environment variables to discover both
  33.     the Pegasus mail directory structure and the KA9Q Spool directory
  34.     structure.  
  35.     
  36.     Place both the GW programs, GWIN.EXE and GWOUT.EXE, in their own
  37.     directory called, for example, GW.
  38.     
  39.     Run PCONFIG in the Pegasus mail directory and create a User Gateway
  40.     using the following entries as a guide:-
  41.     
  42.             Pegasus Mail Login & Interface Maintenance
  43.                 User Gateway Definition
  44.     
  45.     Gateway Name           [GW            ]
  46.     New mail path        d:\gw\gwin.exe ~8
  47.     Is a program to run?     Y
  48.     New mail search mask    *.CNM
  49.     Outgoing mail path    d:\gw
  50.     Run for outgoing mail    d:\gw\gwout.exe ~8 "(~p)"
  51.     Filename format        ~d~d.txt
  52.     Run to validate address
  53.     Reply address format
  54.     Accepts SMTP addresses    Y
  55.     Simple message headers    N
  56.     UUEncode attachments    Y
  57.     Burst messages        N
  58.     Strip GW name        Y
  59.     Check new mail every    30 seconds
  60.     
  61.             (Standalone configuration)
  62.     
  63.     The directory for GW can be anywhere as the Pegasus mail program
  64.     will execute it based on the information placed in the Gateway 
  65.     definition Screen. 
  66.  
  67.     As long as GW is the first defined gateway that can accept 
  68.     Internet addresses then a user need not use a gateway address, 
  69.     GW\name@fred.co.uk, to make sure that it gets sent.
  70.     
  71.     You also need to configure for a standalone user specifying the
  72.     user directory for new mail, and that should be the user directory
  73.     below the PMAIL directory.  For example, the user SLUCY should have
  74.     his mailbox below the PMAIL directory and new mail should also be
  75.     configured to be in this directory.
  76.  
  77.     i.e.    D:\PMAIL
  78.               |SLUCY
  79.               |*.CNM
  80.  
  81.     Having configured Pegasus Mail all that needs to be set up are the
  82.     environment variables for the sets of directories.
  83.     
  84.     SET GW=D:\GW            ; The Gateway directory
  85.     SET PMAIL=D:\PMAIL        ; The Pegasus Mail Directory
  86.     SET KA9Q=D:\SPOOL\MAIL        ; The KA9Q Spool Mail directory
  87.  
  88.     The GWOUT.EXE reads the AUTOEXEC.NET file in the root directory
  89.     of the drive where the SPOOL directory is located for the host
  90.     name.  So no complicated addressing needs to be done in Pegasus.
  91.     
  92.     Operating the Gateway
  93.     
  94.     As long as the above installation has been followed then the 
  95.     operation of the gateway should be transparent and run totally
  96.     from Pegasus.  
  97.     
  98.     After running NET.EXE to connect to the Internet and any mail is
  99.     gathered, run Pegasus and collect that new mail.  Pegasus can also
  100.     be installed to automatically collect new mail on startup.
  101.     
  102.     Pegasus will run GWIN.EXE with the current user name as the 
  103.     parameter.  GWIN then discovers if that name.TXT exists in the
  104.     MAIL directory and if so splits its contents into separate mail.CNM
  105.     files in the users directory.  
  106.     
  107.     In order to send mail correctly define the Address options for
  108.     replying to include the Reply-To field but NOT the To: field.  If
  109.     the configuration is setup correctly then sending the mail by 
  110.     Control-Enter will write the mail to the GW directory and call
  111.     GWOUT with the current user name as the parameter.  
  112.     
  113.     GWOUT will then construct the mail properly for KA9Q and build it
  114.     in the MQUEUE directory.
  115.     
  116.     In order to physically send the mail onto the Internet NET.EXE will
  117.     have to be run as usual.  It is possible to run this from Pegasus
  118.     using Sender.PM.  However, this is not recommended as the memory
  119.     requirements for NET.EXE are quite high.
  120.     
  121.     
  122.     Support
  123.     
  124.     As this is freeware then the amount of support that can be given 
  125.     is necessarily small.  However, questions or suggestions can be
  126.     mailed to gw@sport-pc.demon.co.uk.
  127.     
  128.     FUTURE
  129.     
  130.     I don't particularly think that there is much that can be usefully
  131.     added to this.  It is very simple but does the job.  I haven't 
  132.     tested this as a network based installation.  The only difficulty
  133.     that I can envisage would be in opening the SEQUENCE.SEQ files 
  134.     concurrently.
  135.     
  136.     If this becomes a requirement then I will add it, but in that case
  137.     it will probably need site specific tweaking which is possible but
  138.     not on a freeware basis!
  139.     
  140.  
  141.     
  142.     HISTORY
  143.     
  144.     1.0    Personal use release.  No public copy should have this
  145.         version number.
  146.     1.1    First public release.
  147.     
  148.     1.2    A problem reported about using full names 
  149.         i.e. (Simon P. Lucy) fixed by allowing a second parameter
  150.         to GWOUT.EXE which is the full name string.  To use this
  151.         feature modify the Run for outgoing mail, line in PCONFIG
  152.         to include "(~p)".  The quotes are very important as they
  153.         allow the parameter to be seen as one string.
  154.     
  155.  
  156. Support pc Ltd                       Tel:    (44)-(0)-299-823321
  157.                            Fax: (44)-(0)-299-879047    
  158. Simon P. Lucy
  159. slucy@sport-pc.demon.co.uk
  160.       
  161.